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WHAT IS CLAIMED IS: 



1 LA method for handling errors in a service program including service 

2 functions capable of being called from application programs, comprising: 

3 receiving a call for one service function from a service function call within one 

4 application program; 

5 performing a series of test operations when executing the service function call, 

6 wherein each test operation returns an identifier if the test operation failed, wherein each 

7 identifier is associated with one error state; and 

8 if one test operation failed, transmitting the identifier associated with the error 

9 state of the failed test operation to an error handling agent, wherein the error handling 

1 0 agent accesses error information associated with the identifier and generates error 

1 1 information describing a specific cause of the error that caused the test operation to fail. 

1 2. The method of claim 1, wherein the identifier indicates an occurrence of 

2 an error at a unique location in the service program. 

1 3. The method of claim 1, further comprising: 

2 if no test operation for the called service function failed, then transmitting one 

3 identifier indicating that no error occurred to the error handling agent. 

1 4. The method of claim 1, wherein the error handling agent is separate from 

2 the service program receiving the call. 

1 5. A method for handling errors resulting from execution of a service 

2 function in a service program, wherein one application program calls the service function 

3 in the service program, comprising: 

4 receiving an identifier from the service program executing the service function, 

5 wherein the service program performs a series of test operations when executing the 
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6 service function, wherein each test operation returns one identifier if the test operation 

7 failed that is associated with one error state; 

8 if the received identifier indicates that one error occurred during execution of the 

9 service function, then generating and transmitting a return code to the application 
1 0 program indicating that an error occurred. 

1 6. The method of claim 5, wherein the identifier indicates an occurrence of 

2 an error at a unique location in the service program. 

1 7. The method of claim 5, further comprising: 

2 if the received identifier indicates that one error did not occur during execution of 

3 the service function, then the generated return code indicates that no error occurred. 

1 8. The method of claim 5, further comprising: 

2 returning additional data describing the error to the application program if the 

3 return code indicates that one error occurred. 

1 9. The method of claim 5, wherein the return code comprises generic error 

2 information, wherein one return code is used to provide generic error information for 

3 multiple identifiers. 

1 10. The method of claim 5, further comprising: 

2 receiving data related to the failed test operation from the service program; and 

3 including the received data related to the failed test operation within the generated 

4 error information. 



o 
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1 11. The method of claim 5, further comprising: 

2 generating error information providing a description of the service function error 

3 associated with the received identifier. 

1 12. The method of claim 1 1 , further comprising : 

2 writing the generated error information to a log file. 

1 13. The method of claim 1 1 , further comprising: 

2 providing a directory including entries corresponding to identifiers capable of 

3 being received from the service function, wherein the directory maintains error 

4 information for identifiers that describes a specific cause of the test operation failure 

5 associated with the identifier; 

6 accessing one entry in the directory corresponding to the received identifier, 

7 wherein the generated error information comprises the description of the specific cause of 

8 the error in the directory entry for the received identifier. 

1 14. The method of claim 1 3, wherein the directory further maintains a generic 



2 error code in each entry, wherein the same generic error code is used for multiple 

3 identifiers providing a general description of the error state resulting from the failure of 

1 the test operation, and wherein the return code transmitted to the application program 

2 comprises the generic error code for the received identifier in the directory. 



1 15. The method of claim 1 3, further comprising: 

2 detecting a change in a version number of the service program; 

3 accessing an updated directory reflecting changes resulting from an update to 

4 service functions in the service program; and 

5 replacing the directory with the updated directory, wherein the updated directory 

6 is capable of including modifications to the identifiers and error information. 
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1 16. The method of claim 5, wherein the application program and service 

2 program execute on different computer systems. 

1 17. The method of claim 5, wherein the application program and service 

2 program run on different operating system platforms. 

1 18. The method of claim 5, wherein the service program comprises an 

2 operating system program. 

1 1 9. The method of claim 5, wherein the steps of receiving the identifier, 

2 generating the error information, and transmitting the data are performed by a program 

3 that is external to the application program and service program. 

1 20. A system for handling errors resulting from execution of a service function 

2 in a service program, comprising: 

3 (a) at least one computer readable medium, including: 

4 (i) an application program; 

5 (ii) a service program; 

6 (iii) at least one service function included in the service program; 

7 (iv) an error handling agent; 

8 (b) means, performed by the application program, for calling one service function 

9 in the service program; 

1 0 (c) means, performed by the service program in response to the call to the service 

1 1 function, for: 

12 (i) performing a series of test operations when executing the service 

13 function, wherein each test operation returns one identifier if the test operation 

14 failed that is associated with one error state; 
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1 5 (ii) transmitting the identifier associated with the error state of the failed 

1 6 test operation to the error handling agent if one test operation failed; and 

1 7 (d) means, performed by the error handling agent, for: 

1 8 (i) receiving the identifier from the service program executing the service 

19 function; 

20 (ii) generating and transmitting a return code to the application program 

21 indicating that an error occurred if the received identifier indicates that one error 

22 occurred during execution of the service function. 

1 21. The system of claim 20, wherein the identifier indicates an occurrence of 

2 an error at a unique location in the service program. 

1 22. The system of claim 20, wherein the generated return code indicates that 

2 no error occurred if the received identifier indicates that one error did not occur during 

3 execution of the service function. 

1 23. The system of claim 20, wherein the means performed by the error 

2 handling agent further performs: 

3 returning additional data describing the error to the application program if the 

4 return code indicates that one error occurred. 

1 24. The system of claim 20, wherein the return code comprises generic error 

2 information, wherein one return code is used to provide generic error information for 

3 multiple identifiers. 



1 
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25. The system of claim 20, wherein the means performed by the error 
handling agent further performs: 

receiving data related to the failed test operation from the service program; and 
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4 including the received data related to the failed test operation within the generated 

5 error information. 

1 26. The system of claim 20, wherein the means performed by the error 

2 handling agent further performs: 

3 generating error information providing a description of the service function error 

4 associated with the received identifier. 

1 27. The system of claim 26, wherein the means performed by the error 

2 handling agent further performs: 

3 writing the generated error information to a log file. 

1 28. The system of claim 26, wherein the means performed by the error 

2 handling agent further performs: 

3 providing a directory including entries corresponding to identifiers capable of 

4 being received from the service function, wherein the directory maintains error 

5 information for identifiers that describes a specific cause of the test operation failure 

6 associated with the identifier; and 

7 accessing one entry in the directory corresponding to the received identifier, 

8 wherein the generated error information comprises the description of the specific cause of 

9 the error in the directory entry for the received identifier. 

1 29. The system of claim 28, wherein the directory further maintains a generic 

2 error code in each entry, wherein the same generic error code is used for multiple 

3 identifiers providing a general description of the error state resulting from the failure of 

1 the test operation, and wherein the return code transmitted to the application program 

2 comprises the generic error code for the received identifier in the directory. 
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1 30. The system of claim 28, wherein the means performed by the error 

2 handling agent further performs: 

3 detecting a change in a version number of the service program; 

4 accessing an updated directory reflecting changes resulting from an update to 

5 service functions in the service program; and 

6 replacing the directory with the updated directory, wherein the updated directory 

7 is capable of including modifications to the identifiers and error information. 

1 31. The system of claim 20, wherein the application program and service 

2 program execute on different computer systems. 

1 32. The system of claim 20, wherein the application program and service 

2 program run on different operating system platforms. 

1 33. The system of claim 20, wherein the service program comprises an 

2 operating system program. 

1 34. The system of claim 20, wherein the error handling agent executes 

2 externally from the application program and service program. 

1 35. The system of claim 20, wherein each error state is associated with one 

2 location in source code for the service function call. 

1 36. An article of manufacture including code for handling errors in a service 

2 program including service functions capable of being called from application programs 

3 by: , 

4 receiving a call for one service function from a service function call within one 

5 application program; 
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6 performing a series of test operations when executing the service function call, 

7 wherein each test operation returns an identifier if the test operation failed, wherein each 

8 identifier is associated with one error state; and 

9 if one test operation failed, transmitting the identifier associated with the error 

1 0 state of the failed test operation to an error handling agent, wherein the error handling 

1 1 agent accesses error information associated with the identifier and generates error 

12 information describing a specific cause of the error that caused the test operation to fail. 

1 37. The article of manufacture of claim 36, wherein the identifier indicates an 

2 occurrence of an error at a unique location in the service program. 

1 38. The article of manufacture of claim 36, further comprising: 

2 if no test operation for the called service function failed, then transmitting one 

3 identifier indicating that no error occurred to the error handling agent. 

1 39. The article of manufacture of claim 36, wherein the error handling agent is 

2 separate from the service program receiving the call. 

1 40. An article of manufacture for handling errors resulting from execution of a 

2 service function in a service program, wherein one application program calls the service 

3 function in the service program, by: 

4 receiving an identifier from the service program executing the service function, 

5 wherein the service program performs a series of test operations when executing the 

6 service function, wherein each test operation returns one identifier if the test operation 

7 failed that is associated with one error state; 

8 if the received identifier indicates that one error occurred during execution of the 

9 service function, then generating and transmitting a return code to the application 

1 0 program indicating that an error occurred. 
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1 41 . The article of manufacture of claim 40, wherein the identifier indicates an 

2 occurrence of an error at a unique location in the service program. 

1 42. The article of manufacture of claim 40, further comprising: 

2 if the received identifier indicates that one error did not occur during execution of 

3 the service function, then the generated return code indicates that no error occurred. 

1 43. The article of manufacture of claim 40, further comprising: 

2 returning additional data describing the error to the application program if the 

3 return code indicates that one error occurred. 

1 44. The article of manufacture of claim 40, wherein the return code comprises 

2 generic error information, wherein one return code is used to provide generic error 

3 information for multiple identifiers. 

1 45. The article of manufacture of claim 40, further comprising: 

2 receiving data related to the failed test operation from the service program; and 

3 including the received data related to the failed test operation within the generated 

4 error information. 

1 46. The article of manufacture of claim 40, further comprising: 

2 generating error information providing a description of the service function error 

3 associated with the received identifier. 
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47. The article of manufacture of claim 46, further comprising: 
writing the generated error information to a log file. 
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1 48. The article of manufacture of claim 46, further comprising: 

2 providing a directory including entries corresponding to identifiers capable of 

3 being received from the service function, wherein the directory maintains error 

4 information for identifiers that describes a specific cause of the test operation failure 

5 associated with the identifier; 

6 accessing one entry in the directory corresponding to the received identifier, 

7 wherein the generated error information comprises the description of the specific cause of 

8 the error in the directory entry for the received identifier. 

1 49. The article of manufacture of claim 48, wherein the directory further 

2 maintains a generic error code in each entry, wherein the same generic error code is used 

3 for multiple identifiers providing a general description of the error state resulting from the 

1 failure of the test operation, and wherein the return code transmitted to the application 

2 program comprises the generic error code for the received identifier in the directory. 

1 50. The article of manufacture of claim 48, further comprising: 

2 detecting a change in a version number of the service program; 

3 accessing an updated directory reflecting changes resulting from an update to 

4 service functions in the service program; and 

5 replacing the directory with the updated directory, wherein the updated directory 

6 is capable of including modifications to the identifiers and error information. 

1 51. The article of manufacture of claim 40, wherein the application program 

2 and service program execute on different computer systems. 



1 52. The article of manufacture of claim 40, wherein the application program 

2 and service program run on different operating system platforms. 
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1 53. The article of manufacture of claim 40, wherein the service program 

2 comprises an operating system program. 

1 54. The article of manufacture of claim 40, wherein the steps of receiving the 

2 identifier, generating the error information, and transmitting the data are performed by a 

3 program that is external to the application program and service program. 



